home *** CD-ROM | disk | FTP | other *** search
/ Suzy B Software 2 / Suzy B Software CD-ROM 2 (1994).iso / stos / stos_38 / stoscan.txt < prev    next >
Text File  |  1992-04-28  |  6KB  |  105 lines
  1.  
  2.                     STOS CANADA NEWSLETTER #7 ON DISK
  3.  
  4.  
  5. (Sorry for the delay I was in a bad car accident which kept STOS CANADA
  6.  at a standstill for several months, we are now back on track and have
  7. now resumed to our normal functions. Look for the next newsletter to
  8. explain more of these commands and write me if you prefer to have a disk
  9. or a newsletter hardcopy. Thanks for your strong support!)
  10.  
  11.      This disk contains the information required to use the STOS CANADA goodies
  12. disk  with 100 new commands for STOS. To install the various extensions simply
  13. insert the (.ec?) extensions into your compiler folder and the (.ex?) into your
  14. STOS folder by using the Install.prg. Several of the compiler extensions are
  15. not supplied on this disk (Blitter,Midi,TOME, and 512 Extensions).
  16.      The STOS Tracker extension is a little different to install
  17. because it is 180K large. It had to be squashed to fit on the disk. To
  18. unsquash and install the extension use the trackin.bas program in the
  19. Tracker folder. More documentation of the STOS Tracker is included in the
  20. Tracker folder along with the STOS command usage for the Tracker. The 512
  21. colour extension has a program demo in the OTHER folder on this disk. Simply
  22. load the VIEW512.BAS program and run to see how good it looks in STOS!
  23.      To quickly jump in and try many of these new commands in STOS simply
  24. load and run all the basic programs in the folders on this Disk. Not all the
  25. commands will be covered on this disk but the following will be a short
  26. description of some of the available interpreter commands.
  27.  
  28.  X= STE     This function returns a 1 if you own an STE or 0 if it isnt an STE.
  29.  
  30.  X= LSTICK(J) Returns the current status of the joysticks left position. The
  31. value x holds either -1 if the joystick is in the left position or zero if it
  32. isnt. You can access up to six joysticks where j holds the number of the stick
  33. you want from one to six. The following work the same way for other directions
  34.  X= RSTICK(J) right , X= USTICK(J) up, X= DSTICK(J) down, X= FSTICK(J) fire.
  35.  
  36.  To access the joysticks you need to use the Function STICKS ON. This command
  37. activates the interrupt routine for the joysticks and disables the mouse.
  38. STICKS OFF deactivates the interrupt routine and reactivates the mouse. For
  39. compatability the X=STICK1 and X=STICK2 commands still exist where bit
  40. 0=up if set, 1=down if set, 2=left if set, 3=right if set, 4,5,6 unused and
  41. 7=fire if set. Be sure to include STICKS ON and OFF in your programs!
  42.  
  43.  The STE can also support a light gun or pen. To use the commands try
  44. X= LIGHT X and Y=LIGHT Y. which returns the co-ordinates of the light
  45. gun/pen at the last time the fire button was pressed. To check for the
  46. light gun fire button use FSTICK(3) function.
  47.  
  48.  The extended colour palette on an STE has 4096 colours to choose from.
  49. STOS uses the E PALETTE $RGB,$RGB,...(up to 16 colors) page 122 in STOS manual.
  50. Also E COLOUR colour,$RGB is used the same way as the colour command is STOS
  51. but uses the hex values to access the 4096 colours. X= E COLOR (colour) is
  52. used to return an RGB value of the colour number from 0-15.
  53.  
  54.  STE DAC is one of the best things added to the STE. This brilliant Digital
  55. to Analog converter plays the raw sample sound in stereo, and with the
  56. microwire interface you can set left and right volume controls as well as
  57. treble and bass. DAC CONVERT start address of sample, end address of sample.
  58. Because the STE DAC plays raw sampled sound, you need to convert your STOS
  59. MAESTRO samples. DAC CONVERT does the job very quickly. DAC SPEED where
  60. 0=6khz, 1=12.5khz, 2=25khz and 4 =50khz. DAC RAW start address,end address.
  61. plays yoru raw sampled DAC sounds. DAC MONO and DAC STEREO are straight
  62. forward commands. DAC LOOP ON and DAC LOOP OFF plays your sample endlessly.
  63. DAC M VOLUME volume, DAC L VOLUME volume, DAC R Volume volume,DAC TREBLE volume
  64. and DAC BASS volume, are used to set left and right volume treble and bass
  65. where (volume) is anywhere from 0-12. (EX. DAC BASS 12, or DAC R VOLUME 12)
  66. Also DAC MIX ON and DAC MIX OFF which enables the mix og the PSG sound chip
  67. with the STE's DAC chip. DAC STOP of course stops all DAC processing.
  68.  
  69.  Hardware scrolling in the STE is built into ROM. STE hardware scrolling
  70. enables the screen data to be shifted in bytes rather than words using
  71. hardware. The command HARD SCREEN SIZE w,h,mode is used to set the screens
  72. logical size and w=width of screen, h=height of screen ready for scrolling.
  73. HARD SCREEN OFFSET x,y tells the STE where to start displaying the screen.
  74. X= HARD PHYSIC (screen address) tells the STE where the screen is stored.
  75. Finally HARD INTER ON and HARD INTER OFF turns on and off the hardware
  76. scrolling.
  77.  
  78.  The Midi Extension has four main commands. MIDI ON buffstart,bufend,start,
  79. filter,end., X=MIDI IN, MIDI OUT X, and MIDI OFF. The MIDI ON command
  80. parameters are buffstart= the start address of the bank you will be using
  81. as your Midi buffer(normally 256bytes). Buffend is the end address of the
  82. buffstart address bank. Start is usually set to 0, but is the start
  83. accepting code data value in a midi sequence. The filter code if not set to 0
  84. can be any occurence of this value will be filtered out by a Midi routine.
  85. (handy for getting rid of the $FE active annoyance messages from some synths)
  86. The end code as with the start code if not set to zero will stop receiving data
  87. once this code is received. Now look to the Midicom.bas and the Miditest.bas
  88. files for further Midi command usage. An example program using MIDI ON is
  89.  10 Reserve as work 5,4096: rem sys ex messages are usually quite long
  90.  20 MIDI ON start(5),start(5)+length(5), $F0,0,$F7
  91. This may help you in the design of your midi extension programs.
  92.  
  93.  The STOS squasher extension gives you two new STOS commands;
  94.  X=Squash(start,end) and Unsquash source,destination
  95.  You should use the .ppc extender for your stos squashed files.
  96.  
  97.  The Blitter,Useful and TOME commands have been left out here but you can guess
  98. their usage by trying the programs supplied in the TOME package. Next
  99. Newsletter Issue 8 and 9 will describe these functions in greater detail.
  100.  
  101.  I hope you enjoy many of these new commands and feel free to write or
  102. call the Hotline for further information.
  103.  
  104.                                   STOS CANADA President
  105.